home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / ambos / mailer.lha / Mailer / Mailer.DOK < prev    next >
Text File  |  1995-09-10  |  12KB  |  289 lines
  1.                        Mailer v1.1  (10-Sep-95)
  2.                        ~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Index:            (1).......Sinn und Zweck
  5. ~~~~~~            (2).......Installation
  6.                   (3).......Syntax des Programmes
  7.                   (4).......Aufruf des Programmes ueber die SHELL
  8.                   (5).......Fehlerbehandlung
  9.                   (6).......Aufruf des Programmes als "AutoEvent"
  10.                   (7).......Praktische Anwendungen des Programmes
  11.                   (8).......Letze Bemerkungen
  12.                   (9).......Autor, Kontaktadresse und Greetinx
  13.  
  14.  
  15. 1. Sinn und Zweck:
  16. ~~~~~~~~~~~~~~~~~~
  17. Erstellt  und verschickt anhand einer 'EmpfΣnger-Liste' eine beliebige
  18. Anzahl  von  ZCONNECT-Mails,  deren  Inhalt  in  einem  ASCII-Textfile
  19. vorgegeben  ist.  Daher eignen sich dieses "einfache" Programm gut, um
  20. Rundbriefe  zu  erstellen  (viel Spass, ALWO@eagle.dontpanic.sub.org).
  21. Es werden jeweils einzelne Mails erstellt (kein CrossPostings!).
  22.  
  23.  
  24. 2. Installation:
  25. ~~~~~~~~~~~~~~~~
  26. Alle  Dateien in die entsprechenden Verzeichnisse kopieren (ggf.  neue
  27. Verzeichnisse erstellen). Es MUSS das Verzeichnis
  28.  
  29. BBS:Scripts/Mailer/
  30.  
  31. mit den entsprechenden Files vorhanden sein!
  32.  
  33. Das Programm "SMail"                in C:
  34. Das Programm "SPuffer"              in C:
  35. Das Programm "rexxsupport.library"  in libs:
  36. Das Programm "Mailer"               in BBS:Scripts/Mailer/
  37. Das Programm "Mailer.REXX"          in BBS:Scripts/Mailer/
  38. Das Programm "AutoMailer"           in BBS:Scripts/Mailer/
  39.  
  40. Weiterhin  erforderliche  Files/Programme,  die NICHT in diesem Archiv
  41. vorhanden sind:                                 ~~~~~
  42.  
  43. Das Programm "RX"                   direkt von der SHELL aus aufrufbar
  44.  
  45. Die Befehle "Echo"                  in C: oder resident im KickROM
  46.             "MakeDir"
  47.             "Delete"
  48.  
  49. Anschliessend muessen die beiden folgenden Programme mit dem Schutzbit
  50. "s" (Scriptfile) versehen werden.
  51.  
  52. BBS:Scripts/Mailer/Mailer
  53. BBS:Scripts/Mailer/AutoMailer
  54.  
  55. Dazu kann beispielsweise folgender AmigaOS-Befehl verwendet werden:
  56.  
  57. protect BBS:Scripts/Mailer/Mailer +s
  58. protect BBS:Scripts/Mailer/AutoMailer +s
  59.  
  60.  
  61. 3. Syntax des Programmes:
  62. ~~~~~~~~~~~~~~~~~~~~~~~~~
  63. Das  Programm  "Mailer"  wird in der Regel ueber die SHELL aufgerufen.
  64. Es kann natuerlich auch als Autoevent in AmBoS eingebaut werden (siehe
  65. Punkt 6).  Die korrekte Befehlszeile fuer den SHELL-Aufruf lautet:
  66.  
  67. Mailer ABSENDER SERVER BETREFF LISTE TEXTMAIL
  68.  
  69. Erklaerungen der Parameter:
  70. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71. ABSENDER: VollstΣndige EMail-Adresse des Absenders.
  72.  
  73. SERVER:   Eine andere angeschlossene Mailbox (Site),  welche auch
  74.           Schreibzugriff auf die entsprechenden Netze besitzt.
  75.  
  76. BETREFF:  Beliebige Betreff-Angabe der zu erstellenden Mail.
  77.           Achtung: Nur ein Wort zulΣssig!
  78.  
  79. LISTE:    Pfad- & Filename eines ASCII-Files,  dessen Inhalt alle
  80.           EmpfΣnger als vollstΣndige EMail-Adressen enthΣlt, bzw.
  81.           alle Brettnamen, mit vorgestelltem '/' vor den Angaben.
  82.           (je Zeile ein EmpfΣnger/Brettname).
  83.  
  84. TEXTMAIL: Pfad-  & Filename eines ASCII-Textfiles,  dessen Inhalt
  85.           die eigentliche Mail darstellt,  die an die oben genan-
  86.           nten EmpfΣnger gesendet werden soll.
  87.  
  88. Beispiel:
  89. ~~~~~~~~~
  90. Mailer bAStARd@nasus.north.de HELLGATE An_Alle DH0:Userliste.TXT RAM:TextFile.TXT
  91.  
  92.  
  93. 4. Aufruf des Programmes ueber die SHELL:
  94. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  95. Erstellen  Sie  zuerst  eine Liste mit allen Usern, die eine bestimmte
  96. Mail   erhalten   sollen.    Es   ist   die   komplette  EMail-Adresse
  97. erforderlich.   Sollen  User  in der eigenen Box angeschrieben werden,
  98. dann ist auch in diesem Fall der Username und die vollstaendige EMail-
  99. Adresse  in  der  Liste  anzugeben.   Die  Liste  kann z.B.  mit einem
  100. einfachen   Texteditor   erstellt  sein.   Jeder  einzelne  User  kann
  101. untereinander  aufgefuehrt  werden.  Vermeiden Sie Leerzeilen zwischen
  102. den Zeilen.
  103. Anstatt  eines Usernames (mit EMail-Adresse) kann auch ein Empfaenger-
  104. Brett  angegeben  werden  (siehe  Beispiel  unten).   In dem Fall muss
  105. allerdings  beachtet  werden, dass der "SERVER" Schreibberechtigung in
  106. dem entsprechenden Brett besitzt.
  107. Eine solche Userliste kann beispielsweise wie folgt aussehen:
  108.  
  109. ------------------------------------------------------- cut here -----
  110. bastard@hellgate.dontpanic.sub.org
  111. TESTMAN@nasus.north.de
  112. SUCKER@box.do.main
  113. /AmBoS-NET/TEST/TESTMAILS
  114. /Magical-NET/M01-ALLGEMEIN
  115. ------------------------------------------------------- cut here -----
  116.  
  117. Die  beiden  letzten  Zeilen  (mit  vorgestelltem  Schraegstrich  '/')
  118. stellen Bretter dar (z.B.  Netz-Bretter).
  119. Die  erstellte  Empfaengerliste kann nun unter beliebigen Filename ge-
  120. sichert werden. In unserem Beispiel: "DH0:Userliste.TXT".
  121.  
  122. Erstellen Sie anschliessend ein Textfile, welches die eigentliche Mail
  123. darstellt.   Es kann ein beliebiger Text sein, der ebenfalls mit einem
  124. einfachen  Texteditor  zu  erstellen ist und unter beliebigen Filename
  125. gesichert werden kann.  In unserem Beispiel:  "RAM:TextFile.TXT".  Ein
  126. Beispiel eines Rundbriefes ist in dem Archiv enthalten.
  127.  
  128. Starten Sie nun das Programm mit dem Aufruf:
  129.  
  130. Mailer ABSENDER SERVER BETREFF LISTE TEXTMAIL
  131.  
  132. Setzen Sie fuer die oben stehenden Paramter entsprechende Angaben ein:
  133.  
  134. ABSENDER: Ihren eigenen Usernamen mit EMail-Adresse.
  135.           Z.B.: "bAStARd@hellgate.dontpanic.sub.org" (ohne ' " ')
  136.  
  137. SERVER:   Eine bei ihrem System angeschlossene Mailbox (Site).
  138.           Sollten Sie in der "Userliste" Brett-Angaben haben, dann
  139.           muss dieses Site unbedingt Schreibberechtigung in dem
  140.           entsprechenden Brett/Netz haben (im ZNetz.MOD unter AREAS).
  141.           Z.B.: "NASUS" (ohne ' " ')
  142.  
  143. BETREFF:  Beliebige Betreff-Angabe der zu erstellenden Mail.
  144.           Achtung: Nur ein Wort zulΣssig!
  145.           Z.B.: "Rundbrief" (ohne ' " ')
  146.  
  147. LISTE:    Pfad- & Filename des ASCII-Files, dessen Inhalt die Userliste
  148.           darstellt (EmpfΣnger als vollstΣndige EMail-Adressen, bzw.
  149.           Brettnamen, mit vorgestelltem '/').
  150.           Z.B.: "DH0:Userliste.TXT" (ohne ' " ')
  151.  
  152. TEXTMAIL: Pfad-  & Filename des ASCII-Textfiles, dessen Inhalt die
  153.           eigentliche Mail darstellt,  die als Rundschreiben verschickt
  154.           werden soll.
  155.           Z.B.: "RAM:TextFile.TXT" (ohne ' " ')
  156.  
  157. Es wuerde dann also folgende Befehlszeile entstehen:
  158.  
  159. Mailer bAStARd@hellgate.dontpanic.sub.org NASUS Rundbrief DH0:Userliste.TXT RAM:TextFile.TXT
  160.  
  161. Das  Programm  "Mailer"  liest  nun  die  angegebene Userliste ein und
  162. erstellt  ZCONNECT-Mails,  deren  Inhalt  in  dem  angegebenen  ASCII-
  163. Textfile  stehen.   Anschliessend  werden die Mails an saemtliche User
  164. der  Userliste  verschickt,  bzw.   in  die  dort  angegebenen Bretter
  165. sortiert.
  166. Weiterhin  erhaelt  der User, der unter "ABSENDER" angegeben ist, eine
  167. Report-Mail,  in  der  eine kleine Statistik aufgefuehrt ist, wieviele
  168. Mails  verschickt wurden und an welchen Typ von Empfaengern (User oder
  169. Brett(er)).
  170.  
  171.  
  172. 5. Fehlerbehandlung:
  173. ~~~~~~~~~~~~~~~~~~~~
  174. Das Programm sollte in der Lage sein, moeglichst viele Fehlbedienungen
  175. abzufangen.   Besonders,  da  der  Aufruf  des  Programmes  und  seine
  176. Arbeitsweise  zugegeben  nicht  gerade  auesserst bedienungsfreundlich
  177. sind.  Allerdings erfuellt das kleine AmigaOS-Batchfile und ein AREXX-
  178. Programm  die  Aufgabe,  unter  AmBoS  ueber  die SHELL oder ueber ein
  179. Autoevent Rundbriefe zu erstellen, recht sinnvoll.
  180.  
  181.  
  182. 6. Aufruf des Programmes als "AutoEvent":
  183. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  184. Installieren  Sie  das Programm "Mailer", wie unter Punkt 2 angegeben.
  185. Erstellen  Sie nun eine Liste der Empfaenger und einen ASCII-Text, der
  186. spaeter  die eigentliche Mail darstellt (siehe auch vorangegangene An-
  187. leitung).
  188. Richten Sie nun ein neues "AutoEvent" unter AmBoS ein:
  189.  
  190. AmBoS-SETUP/AutoEvents/ "Neues"
  191.  
  192. Name................: Werbung verschicken
  193. Event Type..........: Extern
  194. Braucht Port........: NEIN
  195. Modul...............: BBS:Scripts/Mailer/AutoMailer
  196.  
  197. Die Einstellungen fuer "Start Zeit"
  198.                        "Start Datum"
  199.                        "Starten bis"
  200.                        "Tage Abstand"
  201.  
  202. koennen natuerlich individuell konfiguriert werden!
  203. Aktivieren  Sie zuletzt noch das neue Event, indem Sie "Eingeschaltet"
  204. anhaken und klicken Sie auf den "SPEICHERN"-Button.
  205.  
  206. Nun  muss  das  File  "BBS:Scripts/Mailer/AutoMailer" editiert werden.
  207. Starten  Sie  dazu  einen beliebigen TextEditor (z.B.  "CygnusED") und
  208. laden  Sie  das  besagte  File  ein.   Am Anfang des Files sind einige
  209. Erklaerungen aufgefuehrt.
  210. Aendern Sie bitte die Angaben in der Zeile:
  211.  
  212. ;*************************************************************************
  213.  
  214. BBS:Scripts/Mailer/Mailer ABSENDER SERVER BETREFF LISTE TEXTFILE
  215.  
  216. ;*************************************************************************
  217.  
  218. In unserem Beispiel muesste die Zeile dann wie folgt lauten:
  219.  
  220. BBS:Scripts/Mailer/Mailer bAStARd@hellgate.dontpanic.sub.org NASUS Rundbrief DH0:Userliste.TXT RAM:TextFile.TXT
  221.  
  222. Zu  den  angegebenen Zeitpunkten wird nun das AutoEvent aufgerufen und
  223. es werden die entsprechenden Rundbriefe verschickt.
  224. An  dieser  Stelle  sollte  noch  erwaehnt  werden, dass unbedingt die
  225. entsprechenden  Netz-Ordnungen  beachtet  werden  muessen!   In vielen
  226. Netzen  ist es nicht zulaessig, in kurz aufeinander folgenden Perioden
  227. Mailbox-Werbungen zu veroeffentlichen.
  228. Ausserdem   machen  Systembetreiber,  die  regelmaessig  und  staendig
  229. Werbungen  in  Netzen  posten  (muessen) sicherlich irgendetwas in der
  230. Organisation  oder  der Verwaltung der eigenen Mailbox total falsch...
  231. Automatisch Werbung verschicken SUXX und is' LAME!  :))
  232.  
  233.  
  234. 7. Praktische Anwendungen des Programmes:
  235. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  236. - Um Rundbriefe an eine bestimmte Usergruppe zu erstellen
  237.   (beispielsweise an alle User, die fuer eine Mailbox gespendet haben)
  238.  
  239. - Um alle (oder nur einige) Bretter eines Netzes zu initialisieren
  240.   (Brett- oder Netz-INIT. Vollkommen automatisch ueber Autoevents).
  241.  
  242. - Um Mailboxwerbungen regelmaessig in eine Vielzahl von Netz-Brettern
  243.   zu posten (vollkommen automatisch ueber Autoevents)
  244.   [ SIEHE HINWEIS AM ENDE VON <Punkt 6> ! ]
  245.  
  246. - Um bestimmte User regelmaessig an ein bestimmtes Ereignis zu erinnern
  247.   (z.B. Passwort-Aenderung, regelmaessige UserTreffen,...)
  248.  
  249. - usw usw usw...
  250.  
  251.  
  252. 8. Letze Bemerkungen:
  253. ~~~~~~~~~~~~~~~~~~~~~
  254. Der  Aufruf des Programmes und seine Arbeitsweise sind zugegeben nicht
  255. gerade auesserst bedienungsfreundlich.  Allerdings erfuellt das kleine
  256. AmigaOS-Batchfile  und  ein  AREXX-Programm  die  Aufgabe, unter AmBoS
  257. ueber  die  SHELL  oder  ueber  ein Autoevent Rundbriefe zu erstellen,
  258. recht sinnvoll.
  259. Es  werden  absichtlich  keine CrossPostings erstellt, sondern jeweils
  260. eigenstaendige  Mails  je  Empfaenger.   Viel Spass beim Erstellen der
  261. Rundbriefe...
  262.  
  263. 9. Autor und Kontaktadresse:
  264. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  265. Autor...................: bAStARd (Sysop der hEllGAtE BBS)
  266. Mailbox.................: hEllGAtE BBS, Delmenhorst
  267. Mailbox-Nummer, Port 1..: 04221 - 121030 (24h tΣglich)
  268. Mailbox-Nummer, Port 2..: 04221 - 121031 (24h tΣglich)
  269. EMail-Adresse...........: bAStARd@hellgate.dontpanic.sub.org
  270.  
  271. Bei  Fragen, Problemen, Verbesserungsvorschlaegen oder sonstigem stehe
  272. ich immer gerne zur Verfuegung!
  273. Es  muss  allerdings  erwaehnt  werden,  dass die oben genannten Daten
  274. (Mailbox  und  -Rufnummern, sowie EMail-Adresse sich in Kuerze aendern
  275. koennen)!
  276.  
  277.    Greetinx:
  278.    ~~~~~~~~~
  279. > an meinen Co-Sysops "McMarco" & "BiG"
  280. > ALWO@eagle.dontpanic.sub.org   (der mich zu diesem Tool verleitete)
  281. > Grisu@adonai.dontpanic.sub.org (fuer das Beta-Testen und testen lassen)
  282. > Joerg & Kai                    (fuer dieses tolle Mailboxprogramm)
  283. > Klaro@nasus.north.de           (fuer den guten Support)
  284.  
  285. ...und  alle,  die  ich kenne (mehr oder weniger), sowie die, mitdenen
  286. ich auf jedem NST 'n Bierchen trinken tu :*)
  287.  
  288. -END OF FILE!-
  289.